8.1.1 Obtain legal currency payment channels

#Brief description: Obtain fiat currency online payment (recharge) channels

• Request method: POST
• Request interface: https://gateway-domain/wallet-trade-merchant/v1/receive/cash/config/channel/options
• Request media type (JSON data format)Content-Type: application/json

Query parameters

Parameter name	Type	Required	Parameter meaning	Parameter description
key	string	Yes	Merchant key	apiKey
merchantId	string	Yes	Merchant ID	Please contact the operation to obtain it or log in to the merchant backend to obtain it
currency	string	Yes	Currency	Legal currency Default CNY
sign	string	Yes	Signature	See Signature Algorithm for details

Request json sample

{
  "key": "dNNTJZpgFVWlYrVv",
  "merchantId": "302992856974",
  "currency": "CNY",
  "sign": "916a6e145819ee0d4bf1b8ab455583b0"
}

Response json example

{
  "code": 0,
  "success": true,
  "message": null,
  "data": [
    {
      "channelCode": "777",
      "name": "M支付-支付宝代收",
      "currency": "CNY",
      "tradeMethod": "BANK",
      "level": 7,
      "limitType": "RANGE",
      "limitPloy": {
        "min": 2000,
        "max": 100000
      },
      "fileDto": null,
      "feature": {
        "featureType": "STABLE",
        "rate": 80,
        "paymentNeedMinuteMin": 0,
        "paymentNeedMinuteMax": 0,
        "collectNeedMinuteMin": 0,
        "collectNeedMinuteMax": 0
      }
    },

    {
      "channelCode": "tencentest9",
      "name": "paytest02-支付宝（tencen用，勿改）",
      "currency": "CNY",
      "tradeMethod": "ALIPAY",
      "level": 4,
      "limitType": "ARRAY",
      "limitPloy": {
        "list": ["100", "500", "1000", "2000"]
      },
      "fileDto": {
        "gid": "x1eBfWZjxyGCxfTgm0o9f1EbMA6iHvv7",
        "fileUrl": "https://dx-orderbucket20230822.s3.ap-southeast-1.amazonaws.com/test/2024/12/Hvlz4TK4FBSCUaGRmF3WvK6V9zZofTit.jpg",
        "previewUrl": "https://dx-orderbucket20230822.s3.ap-southeast-1.amazonaws.com/test/2024/12/preview_Hvlz4TK4FBSCUaGRmF3WvK6V9zZofTit.jpg"
      },
      "feature": {
        "featureType": "UNSTABLE",
        "rate": 80,
        "paymentNeedMinuteMin": 0,
        "paymentNeedMinuteMax": 0,
        "collectNeedMinuteMin": 0,
        "collectNeedMinuteMax": 0
      }
    }
  ]
}

Response data parameter description

Parameter name	Type	Parameter meaning	Parameter description
channelCode	string	Channel code
name	string	Channel name
currency	string	Channel currency
tradeMethod	enum	Channel transaction methods	BANK UnionPay card, ALIPAY Alipay, WECHAT WeChat
level	int	Priority
limitType	enum	Recharge limit policy type	RANGE range
limitPloy	object	Recharge restriction policy	For example, the recharge is fixed to ["100", "500", "1000", "2000"]
fileDto	object	logo attachment information
└ gid	string	Attachment identification ID
└fileUrl	string	File access address
└previewUrl	string	File preview address
feature	object	Channel characteristics
└featureType	enum	Channel feature type	STABLE stable, UNSTABLE unstable
rate	double	Approximate success rate
paymentNeedMinuteMin	int	Minimum withdrawal time range (minutes)
paymentNeedMinuteMax	int	Maximum withdrawal time range (minutes)
collectNeedMinuteMin	int	Minimum recharge time range (minutes)
collectNeedMinuteMax	int	Maximum recharge time range (minutes)